<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html
    PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<!-- /fasttmp/mkdist-qt-4.3.5-1211793125/qtopia-core-opensource-src-4.3.5/src/gui/dialogs/qfiledialog.cpp -->
<head>
  <title>Qt 4.3: QFileDialog Class Reference</title>
  <link href="classic.css" rel="stylesheet" type="text/css" />
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td align="left" valign="top" width="32"><a href="http://www.trolltech.com/products/qt"><img src="images/qt-logo.png" align="left" width="32" height="32" border="0" /></a></td>
<td width="1">&nbsp;&nbsp;</td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a>&nbsp;&middot; <a href="classes.html"><font color="#004faf">All&nbsp;Classes</font></a>&nbsp;&middot; <a href="mainclasses.html"><font color="#004faf">Main&nbsp;Classes</font></a>&nbsp;&middot; <a href="groups.html"><font color="#004faf">Grouped&nbsp;Classes</font></a>&nbsp;&middot; <a href="modules.html"><font color="#004faf">Modules</font></a>&nbsp;&middot; <a href="functions.html"><font color="#004faf">Functions</font></a></td>
<td align="right" valign="top" width="230"><a href="http://www.trolltech.com"><img src="images/trolltech-logo.png" align="right" width="203" height="32" border="0" /></a></td></tr></table><h1 align="center">QFileDialog Class Reference<br /><sup><sup>[<a href="qtgui.html">QtGui</a> module]</sup></sup></h1>
<p>The QFileDialog class provides a dialog that allow users to select files or directories. <a href="#details">More...</a></p>
<pre> #include &lt;QFileDialog&gt;</pre><p>Inherits <a href="qdialog.html">QDialog</a>.</p>
<ul>
<li><a href="qfiledialog-members.html">List of all members, including inherited members</a></li>
<li><a href="qfiledialog-qt3.html">Qt 3 support members</a></li>
</ul>
<a name="public-types"></a>
<h3>Public Types</h3>
<ul>
<li><div class="fn"/>enum <b><a href="qfiledialog.html#AcceptMode-enum">AcceptMode</a></b> { AcceptOpen, AcceptSave }</li>
<li><div class="fn"/>enum <b><a href="qfiledialog.html#DialogLabel-enum">DialogLabel</a></b> { LookIn, FileName, FileType, Accept, Reject }</li>
<li><div class="fn"/>enum <b><a href="qfiledialog.html#FileMode-enum">FileMode</a></b> { AnyFile, ExistingFile, Directory, DirectoryOnly, ExistingFiles }</li>
<li><div class="fn"/>typedef <b><a href="qfiledialog.html#Mode-typedef">Mode</a></b></li>
<li><div class="fn"/>enum <b><a href="qfiledialog.html#Option-enum">Option</a></b> { ShowDirsOnly, DontResolveSymlinks, DontConfirmOverwrite, DontUseSheet, DontUseNativeDialog }</li>
<li><div class="fn"/>flags <b><a href="qfiledialog.html#Option-enum">Options</a></b></li>
<li><div class="fn"/>enum <b><a href="qfiledialog.html#ViewMode-enum">ViewMode</a></b> { Detail, List }</li>
</ul>
<a name="properties"></a>
<h3>Properties</h3>
<p><table width="100%" border="0" cellpadding="0" cellspacing="0">
<tr><td width="45%" valign="top"><ul>
<li><div class="fn"/><b><a href="qfiledialog.html#acceptMode-prop">acceptMode</a></b> : AcceptMode</li>
<li><div class="fn"/><b><a href="qfiledialog.html#confirmOverwrite-prop">confirmOverwrite</a></b> : bool</li>
<li><div class="fn"/><b><a href="qfiledialog.html#defaultSuffix-prop">defaultSuffix</a></b> : QString</li>
<li><div class="fn"/><b><a href="qfiledialog.html#fileMode-prop">fileMode</a></b> : FileMode</li>
</ul></td><td valign="top"><ul>
<li><div class="fn"/><b><a href="qfiledialog.html#readOnly-prop">readOnly</a></b> : bool</li>
<li><div class="fn"/><b><a href="qfiledialog.html#resolveSymlinks-prop">resolveSymlinks</a></b> : bool</li>
<li><div class="fn"/><b><a href="qfiledialog.html#viewMode-prop">viewMode</a></b> : ViewMode</li>
</ul>
</td></tr>
</table></p>
<ul>
<li><div class="fn"/>2 properties inherited from <a href="qdialog.html#properties">QDialog</a></li>
<li><div class="fn"/>56 properties inherited from <a href="qwidget.html#properties">QWidget</a></li>
<li><div class="fn"/>1 property inherited from <a href="qobject.html#properties">QObject</a></li>
</ul>
<a name="public-functions"></a>
<h3>Public Functions</h3>
<ul>
<li><div class="fn"/><b><a href="qfiledialog.html#QFileDialog">QFileDialog</a></b> ( QWidget * <i>parent</i>, Qt::WindowFlags <i>flags</i> )</li>
<li><div class="fn"/><b><a href="qfiledialog.html#QFileDialog-2">QFileDialog</a></b> ( QWidget * <i>parent</i> = 0, const QString &amp; <i>caption</i> = QString(), const QString &amp; <i>directory</i> = QString(), const QString &amp; <i>filter</i> = QString() )</li>
<li><div class="fn"/><b><a href="qfiledialog.html#dtor.QFileDialog">~QFileDialog</a></b> ()</li>
<li><div class="fn"/>AcceptMode <b><a href="qfiledialog.html#acceptMode-prop">acceptMode</a></b> () const</li>
<li><div class="fn"/>bool <b><a href="qfiledialog.html#confirmOverwrite-prop">confirmOverwrite</a></b> () const</li>
<li><div class="fn"/>QString <b><a href="qfiledialog.html#defaultSuffix-prop">defaultSuffix</a></b> () const</li>
<li><div class="fn"/>QDir <b><a href="qfiledialog.html#directory">directory</a></b> () const</li>
<li><div class="fn"/>FileMode <b><a href="qfiledialog.html#fileMode-prop">fileMode</a></b> () const</li>
<li><div class="fn"/>QStringList <b><a href="qfiledialog.html#filters">filters</a></b> () const</li>
<li><div class="fn"/>QStringList <b><a href="qfiledialog.html#history">history</a></b> () const</li>
<li><div class="fn"/>QFileIconProvider * <b><a href="qfiledialog.html#iconProvider">iconProvider</a></b> () const</li>
<li><div class="fn"/>bool <b><a href="qfiledialog.html#readOnly-prop">isReadOnly</a></b> () const</li>
<li><div class="fn"/>QAbstractItemDelegate * <b><a href="qfiledialog.html#itemDelegate">itemDelegate</a></b> () const</li>
<li><div class="fn"/>QString <b><a href="qfiledialog.html#labelText">labelText</a></b> ( DialogLabel <i>label</i> ) const</li>
<li><div class="fn"/>QAbstractProxyModel * <b><a href="qfiledialog.html#proxyModel">proxyModel</a></b> () const</li>
<li><div class="fn"/>bool <b><a href="qfiledialog.html#resolveSymlinks-prop">resolveSymlinks</a></b> () const</li>
<li><div class="fn"/>bool <b><a href="qfiledialog.html#restoreState">restoreState</a></b> ( const QByteArray &amp; <i>state</i> )</li>
<li><div class="fn"/>QByteArray <b><a href="qfiledialog.html#saveState">saveState</a></b> () const</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#selectFile">selectFile</a></b> ( const QString &amp; <i>filename</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#selectFilter">selectFilter</a></b> ( const QString &amp; <i>filter</i> )</li>
<li><div class="fn"/>QStringList <b><a href="qfiledialog.html#selectedFiles">selectedFiles</a></b> () const</li>
<li><div class="fn"/>QString <b><a href="qfiledialog.html#selectedFilter">selectedFilter</a></b> () const</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#acceptMode-prop">setAcceptMode</a></b> ( AcceptMode <i>mode</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#confirmOverwrite-prop">setConfirmOverwrite</a></b> ( bool <i>enabled</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#defaultSuffix-prop">setDefaultSuffix</a></b> ( const QString &amp; <i>suffix</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#setDirectory">setDirectory</a></b> ( const QString &amp; <i>directory</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#setDirectory-2">setDirectory</a></b> ( const QDir &amp; <i>directory</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#fileMode-prop">setFileMode</a></b> ( FileMode <i>mode</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#setFilter">setFilter</a></b> ( const QString &amp; <i>filter</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#setFilters">setFilters</a></b> ( const QStringList &amp; <i>filters</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#setHistory">setHistory</a></b> ( const QStringList &amp; <i>paths</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#setIconProvider">setIconProvider</a></b> ( QFileIconProvider * <i>provider</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#setItemDelegate">setItemDelegate</a></b> ( QAbstractItemDelegate * <i>delegate</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#setLabelText">setLabelText</a></b> ( DialogLabel <i>label</i>, const QString &amp; <i>text</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#setProxyModel">setProxyModel</a></b> ( QAbstractProxyModel * <i>proxyModel</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#readOnly-prop">setReadOnly</a></b> ( bool <i>enabled</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#resolveSymlinks-prop">setResolveSymlinks</a></b> ( bool <i>enabled</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#setSidebarUrls">setSidebarUrls</a></b> ( const QList&lt;QUrl&gt; &amp; <i>urls</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#viewMode-prop">setViewMode</a></b> ( ViewMode <i>mode</i> )</li>
<li><div class="fn"/>QList&lt;QUrl&gt; <b><a href="qfiledialog.html#sidebarUrls">sidebarUrls</a></b> () const</li>
<li><div class="fn"/>ViewMode <b><a href="qfiledialog.html#viewMode-prop">viewMode</a></b> () const</li>
</ul>
<ul>
<li><div class="fn"/>5 public functions inherited from <a href="qdialog.html#public-functions">QDialog</a></li>
<li><div class="fn"/>201 public functions inherited from <a href="qwidget.html#public-functions">QWidget</a></li>
<li><div class="fn"/>29 public functions inherited from <a href="qobject.html#public-functions">QObject</a></li>
<li><div class="fn"/>12 public functions inherited from <a href="qpaintdevice.html#public-functions">QPaintDevice</a></li>
</ul>
<a name="signals"></a>
<h3>Signals</h3>
<ul>
<li><div class="fn"/>void <b><a href="qfiledialog.html#currentChanged">currentChanged</a></b> ( const QString &amp; <i>path</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#directoryEntered">directoryEntered</a></b> ( const QString &amp; <i>directory</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#filesSelected">filesSelected</a></b> ( const QStringList &amp; <i>selected</i> )</li>
<li><div class="fn"/>void <b><a href="qfiledialog.html#filterSelected">filterSelected</a></b> ( const QString &amp; <i>filter</i> )</li>
</ul>
<ul>
<li><div class="fn"/>3 signals inherited from <a href="qdialog.html#signals">QDialog</a></li>
<li><div class="fn"/>1 signal inherited from <a href="qwidget.html#signals">QWidget</a></li>
<li><div class="fn"/>1 signal inherited from <a href="qobject.html#signals">QObject</a></li>
</ul>
<a name="static-public-members"></a>
<h3>Static Public Members</h3>
<ul>
<li><div class="fn"/>QString <b><a href="qfiledialog.html#getExistingDirectory">getExistingDirectory</a></b> ( QWidget * <i>parent</i> = 0, const QString &amp; <i>caption</i> = QString(), const QString &amp; <i>dir</i> = QString(), Options <i>options</i> = ShowDirsOnly )</li>
<li><div class="fn"/>QString <b><a href="qfiledialog.html#getOpenFileName">getOpenFileName</a></b> ( QWidget * <i>parent</i> = 0, const QString &amp; <i>caption</i> = QString(), const QString &amp; <i>dir</i> = QString(), const QString &amp; <i>filter</i> = QString(), QString * <i>selectedFilter</i> = 0, Options <i>options</i> = 0 )</li>
<li><div class="fn"/>QStringList <b><a href="qfiledialog.html#getOpenFileNames">getOpenFileNames</a></b> ( QWidget * <i>parent</i> = 0, const QString &amp; <i>caption</i> = QString(), const QString &amp; <i>dir</i> = QString(), const QString &amp; <i>filter</i> = QString(), QString * <i>selectedFilter</i> = 0, Options <i>options</i> = 0 )</li>
<li><div class="fn"/>QString <b><a href="qfiledialog.html#getSaveFileName">getSaveFileName</a></b> ( QWidget * <i>parent</i> = 0, const QString &amp; <i>caption</i> = QString(), const QString &amp; <i>dir</i> = QString(), const QString &amp; <i>filter</i> = QString(), QString * <i>selectedFilter</i> = 0, Options <i>options</i> = 0 )</li>
</ul>
<ul>
<li><div class="fn"/>4 static public members inherited from <a href="qwidget.html#static-public-members">QWidget</a></li>
<li><div class="fn"/>5 static public members inherited from <a href="qobject.html#static-public-members">QObject</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li><div class="fn"/>4 public slots inherited from <a href="qdialog.html#public-slots">QDialog</a></li>
<li><div class="fn"/>19 public slots inherited from <a href="qwidget.html#public-slots">QWidget</a></li>
<li><div class="fn"/>1 public slot inherited from <a href="qobject.html#public-slots">QObject</a></li>
<li><div class="fn"/>38 protected functions inherited from <a href="qwidget.html#protected-functions">QWidget</a></li>
<li><div class="fn"/>7 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
<li><div class="fn"/>1 protected function inherited from <a href="qpaintdevice.html#protected-functions">QPaintDevice</a></li>
<li><div class="fn"/>1 protected slot inherited from <a href="qwidget.html#protected-slots">QWidget</a></li>
</ul>
<a name="details"></a>
<hr />
<h2>Detailed Description</h2>
<p>The QFileDialog class provides a dialog that allow users to select files or directories.</p>
<p>The QFileDialog class enables a user to traverse the file system in order to select one or many files or a directory.</p>
<p>The easiest way to create a QFileDialog is to use the static functions. On Windows, these static functions will call the native Windows file dialog, and on Mac OS X these static function will call the native Mac OS X file dialog.</p>
<pre> fileName = QFileDialog::getOpenFileName(this,
     tr(&quot;Open Image&quot;), &quot;/home/jana&quot;, tr(&quot;Image Files (*.png *.jpg *.bmp)&quot;));</pre>
<p>In the above example, a modal QFileDialog is created using a static function. The dialog initially displays the contents of the &quot;/home/jana&quot; directory, and displays files matching the patterns given in the string &quot;Image Files (*.png *.jpg *.bmp)&quot;. The parent of the file dialog is set to <i>this</i>, and the window title is set to &quot;Open Image&quot;.</p>
<p>If you want to use multiple filters, separate each one with <i>two</i> semicolons. For example:</p>
<pre> &quot;Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)&quot;</pre>
<p>You can create your own QFileDialog without using the static functions. By calling <a href="qfiledialog.html#fileMode-prop">setFileMode</a>(), you can specify what the user must select in the dialog:</p>
<pre> QFileDialog dialog(this);
 dialog.setFileMode(QFileDialog::AnyFile);</pre>
<p>In the above example, the mode of the file dialog is set to <a href="qfiledialog.html#FileMode-enum">AnyFile</a>, meaning that the user can select any file, or even specify a file that doesn't exist. This mode is useful for creating a &quot;Save As&quot; file dialog. Use <a href="qfiledialog.html#FileMode-enum">ExistingFile</a> if the user must select an existing file, or <a href="qfiledialog.html#FileMode-enum">Directory</a> if only a directory may be selected. See the <a href="qfiledialog.html#FileMode-enum">QFileDialog::FileMode</a> enum for the complete list of modes.</p>
<p>The <a href="qfiledialog.html#fileMode-prop">fileMode</a> property contains the mode of operation for the dialog; this indicates what types of objects the user is expected to select. Use <a href="qfiledialog.html#setFilter">setFilter</a>() to set the dialog's file filter. For example:</p>
<pre> dialog.setFilter(tr(&quot;Images (*.png *.xpm *.jpg)&quot;));</pre>
<p>In the above example, the filter is set to <tt>&quot;Images (*.png *.xpm *.jpg)&quot;</tt>, this means that only files with the extension <tt>png</tt>, <tt>xpm</tt>, or <tt>jpg</tt> will be shown in the QFileDialog. You can apply several filters by using <a href="qfiledialog.html#setFilters">setFilters</a>(). Use <a href="qfiledialog.html#selectFilter">selectFilter</a>() to select one of the filters you've given as the file dialog's default filter.</p>
<p>The file dialog has two view modes: <a href="qfiledialog.html#ViewMode-enum">List</a> and <a href="qfiledialog.html#ViewMode-enum">Detail</a>. <a href="qfiledialog.html#ViewMode-enum">List</a> presents the contents of the current directory as a list of file and directory names. <a href="qfiledialog.html#ViewMode-enum">Detail</a> also displays a list of file and directory names, but provides additional information alongside each name, such as the file size and modification date. Set the mode with <a href="qfiledialog.html#viewMode-prop">setViewMode</a>():</p>
<pre> dialog.setViewMode(QFileDialog::Detail);</pre>
<p>The last important function you will need to use when creating your own file dialog is <a href="qfiledialog.html#selectedFiles">selectedFiles</a>().</p>
<pre> QStringList fileNames;
 if (dialog.exec())
     fileNames = dialog.selectedFiles();</pre>
<p>In the above example, a modal file dialog is created and shown. If the user clicked OK, the file they selected is put in <tt>fileName</tt>.</p>
<p>The dialog's working directory can be set with <a href="qfiledialog.html#setDirectory">setDirectory</a>(). Each file in the current directory can be selected using the <a href="qfiledialog.html#selectFile">selectFile</a>() function.</p>
<p>The <a href="dialogs-standarddialogs.html">Standard Dialogs</a> example shows how to use QFileDialog as well as other built-in Qt dialogs.</p>
<p>See also <a href="qdir.html">QDir</a>, <a href="qfileinfo.html">QFileInfo</a>, <a href="qfile.html">QFile</a>, <a href="qprintdialog.html">QPrintDialog</a>, <a href="qcolordialog.html">QColorDialog</a>, <a href="qfontdialog.html">QFontDialog</a>, <a href="dialogs-standarddialogs.html">Standard Dialogs Example</a>, and <a href="mainwindows-application.html">Application Example</a>.</p>
<hr />
<h2>Member Type Documentation</h2>
<h3 class="fn"><a name="AcceptMode-enum"></a>enum QFileDialog::AcceptMode</h3>
<p><table border="1" cellpadding="2" cellspacing="1" width="40%">
<tr><th width="60%">Constant</th><th width="40%">Value</th></tr>
<tr><td valign="top"><tt>QFileDialog::AcceptOpen</tt></td><td align="center" valign="top"><tt>0</tt></td></tr>
<tr><td valign="top"><tt>QFileDialog::AcceptSave</tt></td><td align="center" valign="top"><tt>1</tt></td></tr>
</table></p>
<h3 class="fn"><a name="DialogLabel-enum"></a>enum QFileDialog::DialogLabel</h3>
<p><table border="1" cellpadding="2" cellspacing="1" width="40%">
<tr><th width="60%">Constant</th><th width="40%">Value</th></tr>
<tr><td valign="top"><tt>QFileDialog::LookIn</tt></td><td align="center" valign="top"><tt>0</tt></td></tr>
<tr><td valign="top"><tt>QFileDialog::FileName</tt></td><td align="center" valign="top"><tt>1</tt></td></tr>
<tr><td valign="top"><tt>QFileDialog::FileType</tt></td><td align="center" valign="top"><tt>2</tt></td></tr>
<tr><td valign="top"><tt>QFileDialog::Accept</tt></td><td align="center" valign="top"><tt>3</tt></td></tr>
<tr><td valign="top"><tt>QFileDialog::Reject</tt></td><td align="center" valign="top"><tt>4</tt></td></tr>
</table></p>
<h3 class="fn"><a name="FileMode-enum"></a>enum QFileDialog::FileMode</h3>
<p>This enum is used to indicate what the user may select in the file dialog; i.e&#x2e; what the dialog will return if the user clicks OK.</p>
<p><table border="1" cellpadding="2" cellspacing="1" width="100%">
<tr><th width="25%">Constant</th><th width="15%">Value</th><th width="60%">Description</th></tr>
<tr><td valign="top"><tt>QFileDialog::AnyFile</tt></td><td align="center" valign="top"><tt>0</tt></td><td valign="top">The name of a file, whether it exists or not.</td></tr>
<tr><td valign="top"><tt>QFileDialog::ExistingFile</tt></td><td align="center" valign="top"><tt>1</tt></td><td valign="top">The name of a single existing file.</td></tr>
<tr><td valign="top"><tt>QFileDialog::Directory</tt></td><td align="center" valign="top"><tt>2</tt></td><td valign="top">The name of a directory. Both files and directories are displayed.</td></tr>
<tr><td valign="top"><tt>QFileDialog::DirectoryOnly</tt></td><td align="center" valign="top"><tt>4</tt></td><td valign="top">The name of a directory. The file dialog will only display directories.</td></tr>
<tr><td valign="top"><tt>QFileDialog::ExistingFiles</tt></td><td align="center" valign="top"><tt>3</tt></td><td valign="top">The names of zero or more existing files.</td></tr>
</table></p>
<p>See also <a href="qfiledialog.html#fileMode-prop">setFileMode</a>().</p>
<h3 class="fn"><a name="Mode-typedef"></a>typedef QFileDialog::Mode</h3>
<p>Use <a href="qfiledialog.html#FileMode-enum">QFileDialog::FileMode</a> instead.</p>
<h3 class="flags"><a name="Option-enum"></a>enum QFileDialog::Option<br />flags QFileDialog::Options</h3>
<p><table border="1" cellpadding="2" cellspacing="1" width="100%">
<tr><th width="25%">Constant</th><th width="15%">Value</th><th width="60%">Description</th></tr>
<tr><td valign="top"><tt>QFileDialog::ShowDirsOnly</tt></td><td align="center" valign="top"><tt>0x01</tt></td><td valign="top">Only show directories in the file dialog. By default both files and directories are shown.</td></tr>
<tr><td valign="top"><tt>QFileDialog::DontResolveSymlinks</tt></td><td align="center" valign="top"><tt>0x02</tt></td><td valign="top">Don't resolve symlinks in the file dialog. By default symlinks are resolved.</td></tr>
<tr><td valign="top"><tt>QFileDialog::DontConfirmOverwrite</tt></td><td align="center" valign="top"><tt>0x04</tt></td><td valign="top">Don't ask for confirmation if an existing file is selected. By default confirmation is requested.</td></tr>
<tr><td valign="top"><tt>QFileDialog::DontUseSheet</tt></td><td align="center" valign="top"><tt>0x08</tt></td><td valign="top">Don't make the native file dialog a sheet. By default on Mac OS X, the native file dialog is made a sheet if it has a parent that can take a sheet.</td></tr>
<tr><td valign="top"><tt>QFileDialog::DontUseNativeDialog</tt></td><td align="center" valign="top"><tt>0x10</tt></td><td valign="top">Don't use the native file dialog. By default on Mac OS X and Windows, the native file dialog is used.</td></tr>
</table></p>
<p>The Options type is a typedef for <a href="qflags.html">QFlags</a>&lt;Option&gt;. It stores an OR combination of Option values.</p>
<h3 class="fn"><a name="ViewMode-enum"></a>enum QFileDialog::ViewMode</h3>
<p>This enum describes the view mode of the file dialog; i.e&#x2e; what information about each file will be displayed.</p>
<p><table border="1" cellpadding="2" cellspacing="1" width="100%">
<tr><th width="25%">Constant</th><th width="15%">Value</th><th width="60%">Description</th></tr>
<tr><td valign="top"><tt>QFileDialog::Detail</tt></td><td align="center" valign="top"><tt>0</tt></td><td valign="top">Displays an icon, a name, and details for each item in the directory.</td></tr>
<tr><td valign="top"><tt>QFileDialog::List</tt></td><td align="center" valign="top"><tt>1</tt></td><td valign="top">Displays only an icon and a name for each item in the directory.</td></tr>
</table></p>
<p>See also <a href="qfiledialog.html#viewMode-prop">setViewMode</a>().</p>
<hr />
<h2>Property Documentation</h2>
<h3 class="fn"><a name="acceptMode-prop"></a>acceptMode : <a href="qfiledialog.html#AcceptMode-enum">AcceptMode</a></h3>
<p>This property holds the accept mode of the dialog.</p>
<p>The action mode defines whether the dialog is for opening or saving files.</p>
<p>Access functions:</p>
<ul>
<li><div class="fn"/><b>AcceptMode acceptMode () const</b></li>
<li><div class="fn"/><b>void setAcceptMode ( AcceptMode <i>mode</i> )</b></li>
</ul>
<p>See also <a href="qfiledialog.html#AcceptMode-enum">AcceptMode</a>.</p>
<h3 class="fn"><a name="confirmOverwrite-prop"></a>confirmOverwrite : bool</h3>
<p>This property holds whether the filedialog should ask before accepting a selected file, when the accept mode is AcceptSave.</p>
<p>If this property is set to true and the accept mode is <a href="qfiledialog.html#AcceptMode-enum">AcceptSave</a>, the filedialog will ask whether the user wants to overwrite the file before accepting the file.</p>
<p>Access functions:</p>
<ul>
<li><div class="fn"/><b>bool confirmOverwrite () const</b></li>
<li><div class="fn"/><b>void setConfirmOverwrite ( bool <i>enabled</i> )</b></li>
</ul>
<h3 class="fn"><a name="defaultSuffix-prop"></a>defaultSuffix : <a href="qstring.html">QString</a></h3>
<p>This property holds suffix added to the filename if no other suffix was specified.</p>
<p>This property specifies a string that will be added to the filename if it has no suffix already. The suffix is typically used to indicate the file type (e.g&#x2e; &quot;txt&quot; indicates a text file).</p>
<p>Access functions:</p>
<ul>
<li><div class="fn"/><b>QString defaultSuffix () const</b></li>
<li><div class="fn"/><b>void setDefaultSuffix ( const QString &amp; <i>suffix</i> )</b></li>
</ul>
<h3 class="fn"><a name="fileMode-prop"></a>fileMode : <a href="qfiledialog.html#FileMode-enum">FileMode</a></h3>
<p>This property holds the file mode of the dialog.</p>
<p>The file mode defines the number and type of items that the user is expected to select in the dialog.</p>
<p>Access functions:</p>
<ul>
<li><div class="fn"/><b>FileMode fileMode () const</b></li>
<li><div class="fn"/><b>void setFileMode ( FileMode <i>mode</i> )</b></li>
</ul>
<p>See also <a href="qfiledialog.html#FileMode-enum">FileMode</a>.</p>
<h3 class="fn"><a name="readOnly-prop"></a>readOnly : bool</h3>
<p>This property holds whether the filedialog is readonly.</p>
<p>If this property is set to false, the filedialog will allow renaming, and deleting of files and directories and creating directories.</p>
<p>The default value is false.</p>
<p>Access functions:</p>
<ul>
<li><div class="fn"/><b>bool isReadOnly () const</b></li>
<li><div class="fn"/><b>void setReadOnly ( bool <i>enabled</i> )</b></li>
</ul>
<h3 class="fn"><a name="resolveSymlinks-prop"></a>resolveSymlinks : bool</h3>
<p>This property holds whether the filedialog should resolve shortcuts.</p>
<p>If this property is set to true, the file dialog will resolve shortcuts.</p>
<p>Access functions:</p>
<ul>
<li><div class="fn"/><b>bool resolveSymlinks () const</b></li>
<li><div class="fn"/><b>void setResolveSymlinks ( bool <i>enabled</i> )</b></li>
</ul>
<h3 class="fn"><a name="viewMode-prop"></a>viewMode : <a href="qfiledialog.html#ViewMode-enum">ViewMode</a></h3>
<p>This property holds the way files and directories are displayed in the dialog.</p>
<p>By default, the <tt>Detail</tt> mode is used to display information about files and directories.</p>
<p>Access functions:</p>
<ul>
<li><div class="fn"/><b>ViewMode viewMode () const</b></li>
<li><div class="fn"/><b>void setViewMode ( ViewMode <i>mode</i> )</b></li>
</ul>
<p>See also <a href="qfiledialog.html#ViewMode-enum">ViewMode</a>.</p>
<hr />
<h2>Member Function Documentation</h2>
<h3 class="fn"><a name="QFileDialog"></a>QFileDialog::QFileDialog ( <a href="qwidget.html">QWidget</a> * <i>parent</i>, <a href="qt.html#WindowType-enum">Qt::WindowFlags</a> <i>flags</i> )</h3>
<p>Constructs a file dialog with the given <i>parent</i> and widget <i>flags</i>.</p>
<h3 class="fn"><a name="QFileDialog-2"></a>QFileDialog::QFileDialog ( <a href="qwidget.html">QWidget</a> * <i>parent</i> = 0, const <a href="qstring.html">QString</a> &amp; <i>caption</i> = QString(), const <a href="qstring.html">QString</a> &amp; <i>directory</i> = QString(), const <a href="qstring.html">QString</a> &amp; <i>filter</i> = QString() )</h3>
<p>Constructs a file dialog with the given <i>parent</i> and <i>caption</i> that initially displays the contents of the specified <i>directory</i>. The contents of the directory are filtered before being shown in the dialog, using a semicolon-separated list of filters specified by <i>filter</i>.</p>
<h3 class="fn"><a name="dtor.QFileDialog"></a>QFileDialog::~QFileDialog ()</h3>
<p>Destroys the file dialog.</p>
<h3 class="fn"><a name="currentChanged"></a>void QFileDialog::currentChanged ( const <a href="qstring.html">QString</a> &amp; <i>path</i> )&nbsp;&nbsp;<tt> [signal]</tt></h3>
<p>When the current file changes, this signal is emitted with the new file name as the <i>path</i> parameter.</p>
<p>See also <a href="qfiledialog.html#filesSelected">filesSelected</a>().</p>
<h3 class="fn"><a name="directory"></a><a href="qdir.html">QDir</a> QFileDialog::directory () const</h3>
<p>Returns the directory currently being displayed in the dialog.</p>
<p>See also <a href="qfiledialog.html#setDirectory">setDirectory</a>().</p>
<h3 class="fn"><a name="directoryEntered"></a>void QFileDialog::directoryEntered ( const <a href="qstring.html">QString</a> &amp; <i>directory</i> )&nbsp;&nbsp;<tt> [signal]</tt></h3>
<p>This signal is emitted when the user enters a <i>directory</i>.</p>
<p>This function was introduced in Qt 4.3.</p>
<h3 class="fn"><a name="filesSelected"></a>void QFileDialog::filesSelected ( const <a href="qstringlist.html">QStringList</a> &amp; <i>selected</i> )&nbsp;&nbsp;<tt> [signal]</tt></h3>
<p>When the selection changes, this signal is emitted with the (possibly empty) list of <i>selected</i> files.</p>
<p>See also <a href="qfiledialog.html#currentChanged">currentChanged</a>().</p>
<h3 class="fn"><a name="filterSelected"></a>void QFileDialog::filterSelected ( const <a href="qstring.html">QString</a> &amp; <i>filter</i> )&nbsp;&nbsp;<tt> [signal]</tt></h3>
<p>This signal is emitted when the user selects a <i>filter</i>.</p>
<p>This function was introduced in Qt 4.3.</p>
<h3 class="fn"><a name="filters"></a><a href="qstringlist.html">QStringList</a> QFileDialog::filters () const</h3>
<p>Returns the file type filters that are in operation on this file dialog.</p>
<p>See also <a href="qfiledialog.html#setFilters">setFilters</a>().</p>
<h3 class="fn"><a name="getExistingDirectory"></a><a href="qstring.html">QString</a> QFileDialog::getExistingDirectory ( <a href="qwidget.html">QWidget</a> * <i>parent</i> = 0, const <a href="qstring.html">QString</a> &amp; <i>caption</i> = QString(), const <a href="qstring.html">QString</a> &amp; <i>dir</i> = QString(), <a href="qfiledialog.html#Option-enum">Options</a> <i>options</i> = ShowDirsOnly )&nbsp;&nbsp;<tt> [static]</tt></h3>
<p>This is a convenience static function that will return an existing directory selected by the user.</p>
<pre> QString dir = QFileDialog::getExistingDirectory(this, tr(&quot;Open Directory&quot;),
                                                 &quot;/home&quot;,
                                                 QFileDialog::ShowDirsOnly
                                                 | QFileDialog::DontResolveSymlinks);</pre>
<p>This function creates a modal file dialog with the given <i>parent</i> widget. If the parent is not 0, the dialog will be shown centered over the parent widget.</p>
<p>The dialog's working directory is set to <i>dir</i>, and the caption is set to <i>caption</i>. Either of these may be an empty string in which case the current directory and a default caption will be used respectively. The <i>options</i> argument holds various options about how to run the dialog, see the <a href="qfiledialog.html#Option-enum">QFileDialog::Option</a> enum for more information on the flags you can pass.</p>
<p>Under Windows and Mac OS X, this static function will use the native file dialog and not a <a href="qfiledialog.html">QFileDialog</a>. On Mac OS X, the <i>dir</i> argument is ignored, the native dialog always displays the last visited directory.</p>
<p>Under Unix/X11, the normal behavior of the file dialog is to resolve and follow symlinks. For example, if <tt>/usr/tmp</tt> is a symlink to <tt>/var/tmp</tt>, the file dialog will change to <tt>/var/tmp</tt> after entering <tt>/usr/tmp</tt>. If <i>options</i> includes <a href="qfiledialog.html#Option-enum">DontResolveSymlinks</a>, the file dialog will treat symlinks as regular directories.</p>
<p>Note that on Windows the dialog will spin a blocking modal event loop that will not dispatch any QTimers, and if parent is not 0 then it will position the dialog just under the parent's title bar.</p>
<p>See also <a href="qfiledialog.html#getOpenFileName">getOpenFileName</a>(), <a href="qfiledialog.html#getOpenFileNames">getOpenFileNames</a>(), and <a href="qfiledialog.html#getSaveFileName">getSaveFileName</a>().</p>
<h3 class="fn"><a name="getOpenFileName"></a><a href="qstring.html">QString</a> QFileDialog::getOpenFileName ( <a href="qwidget.html">QWidget</a> * <i>parent</i> = 0, const <a href="qstring.html">QString</a> &amp; <i>caption</i> = QString(), const <a href="qstring.html">QString</a> &amp; <i>dir</i> = QString(), const <a href="qstring.html">QString</a> &amp; <i>filter</i> = QString(), <a href="qstring.html">QString</a> * <i>selectedFilter</i> = 0, <a href="qfiledialog.html#Option-enum">Options</a> <i>options</i> = 0 )&nbsp;&nbsp;<tt> [static]</tt></h3>
<p>This is a convenience static function that returns an existing file selected by the user. If the user presses Cancel, it returns a null string.</p>
<pre> QString fileName = QFileDialog::getOpenFileName(this, tr(&quot;Open File&quot;),
                                                 &quot;/home&quot;,
                                                 tr(&quot;Images (*.png *.xpm *.jpg)&quot;));</pre>
<p>The function creates a modal file dialog with the given <i>parent</i> widget. If the parent is not 0, the dialog will be shown centered over the parent widget.</p>
<p>The file dialog's working directory will be set to <i>dir</i>. If <i>dir</i> includes a file name, the file will be selected. Only files that match the given <i>filter</i> are shown. The filter selected is set to <i>selectedFilter</i>. The parameters <i>dir</i>, <i>selectedFilter</i>, and <i>filter</i> may be empty strings. The <i>options</i> argument holds various options about how to run the dialog, see the <a href="qfiledialog.html#Option-enum">QFileDialog::Option</a> enum for more information on the flags you can pass.</p>
<p>The dialog's caption is set to <i>caption</i>. If <i>caption</i> is not specified then a default caption will be used.</p>
<p>Under Windows and Mac OS X, this static function will use the native file dialog and not a <a href="qfiledialog.html">QFileDialog</a>. On Mac OS X, the <i>dir</i> argument is ignored, the native dialog always displays the last visited directory.</p>
<p>Note that on Windows the dialog will spin a blocking modal event loop that will not dispatch any QTimers, and if parent is not 0 then it will position the dialog just under the parent's title bar.</p>
<p>Under Unix/X11, the normal behavior of the file dialog is to resolve and follow symlinks. For example, if <tt>/usr/tmp</tt> is a symlink to <tt>/var/tmp</tt>, the file dialog will change to <tt>/var/tmp</tt> after entering <tt>/usr/tmp</tt>. If <i>options</i> includes <a href="qfiledialog.html#Option-enum">DontResolveSymlinks</a>, the file dialog will treat symlinks as regular directories.</p>
<p>See also <a href="qfiledialog.html#getOpenFileNames">getOpenFileNames</a>(), <a href="qfiledialog.html#getSaveFileName">getSaveFileName</a>(), and <a href="qfiledialog.html#getExistingDirectory">getExistingDirectory</a>().</p>
<h3 class="fn"><a name="getOpenFileNames"></a><a href="qstringlist.html">QStringList</a> QFileDialog::getOpenFileNames ( <a href="qwidget.html">QWidget</a> * <i>parent</i> = 0, const <a href="qstring.html">QString</a> &amp; <i>caption</i> = QString(), const <a href="qstring.html">QString</a> &amp; <i>dir</i> = QString(), const <a href="qstring.html">QString</a> &amp; <i>filter</i> = QString(), <a href="qstring.html">QString</a> * <i>selectedFilter</i> = 0, <a href="qfiledialog.html#Option-enum">Options</a> <i>options</i> = 0 )&nbsp;&nbsp;<tt> [static]</tt></h3>
<p>This is a convenience static function that will return one or more existing files selected by the user.</p>
<pre> QStringList files = QFileDialog::getOpenFileNames(
                         this,
                         &quot;Select one or more files to open&quot;,
                         &quot;/home&quot;,
                         &quot;Images (*.png *.xpm *.jpg)&quot;);</pre>
<p>This function creates a modal file dialog with the given <i>parent</i> widget. If the parent is not 0, the dialog will be shown centered over the parent widget.</p>
<p>The file dialog's working directory will be set to <i>dir</i>. If <i>dir</i> includes a file name, the file will be selected. The filter is set to <i>filter</i> so that only those files which match the filter are shown. The filter selected is set to <i>selectedFilter</i>. The parameters <i>dir</i>, <i>selectedFilter</i> and <i>filter</i> may be empty strings.</p>
<p>The dialog's caption is set to <i>caption</i>. If <i>caption</i> is not specified then a default caption will be used.</p>
<p>Under Windows and Mac OS X, this static function will use the native file dialog and not a <a href="qfiledialog.html">QFileDialog</a>. On Mac OS X, the <i>dir</i> argument is ignored, the native dialog always displays the last visited directory.</p>
<p>Note that on Windows the dialog will spin a blocking modal event loop that will not dispatch any QTimers, and if parent is not 0 then it will position the dialog just under the parent's title bar.</p>
<p>Under Unix/X11, the normal behavior of the file dialog is to resolve and follow symlinks. For example, if <tt>/usr/tmp</tt> is a symlink to <tt>/var/tmp</tt>, the file dialog will change to <tt>/var/tmp</tt> after entering <tt>/usr/tmp</tt>. The <i>options</i> argument holds various options about how to run the dialog, see the <a href="qfiledialog.html#Option-enum">QFileDialog::Option</a> enum for more information on the flags you can pass.</p>
<p>Note that if you want to iterate over the list of files, you should iterate over a copy. For example:</p>
<pre> QStringList list = files;
 QStringList::Iterator it = list.begin();
 while(it != list.end()) {
     myProcessing(*it);
     ++it;
 }</pre>
<p>See also <a href="qfiledialog.html#getOpenFileName">getOpenFileName</a>(), <a href="qfiledialog.html#getSaveFileName">getSaveFileName</a>(), and <a href="qfiledialog.html#getExistingDirectory">getExistingDirectory</a>().</p>
<h3 class="fn"><a name="getSaveFileName"></a><a href="qstring.html">QString</a> QFileDialog::getSaveFileName ( <a href="qwidget.html">QWidget</a> * <i>parent</i> = 0, const <a href="qstring.html">QString</a> &amp; <i>caption</i> = QString(), const <a href="qstring.html">QString</a> &amp; <i>dir</i> = QString(), const <a href="qstring.html">QString</a> &amp; <i>filter</i> = QString(), <a href="qstring.html">QString</a> * <i>selectedFilter</i> = 0, <a href="qfiledialog.html#Option-enum">Options</a> <i>options</i> = 0 )&nbsp;&nbsp;<tt> [static]</tt></h3>
<p>This is a convenience static function that will return a file name selected by the user. The file does not have to exist.</p>
<p>It creates a modal file dialog with the given <i>parent</i> widget. If the parent is not 0, the dialog will be shown centered over the parent widget.</p>
<pre> QString fileName = QFileDialog::getSaveFileName(this, tr(&quot;Save File&quot;),
                            &quot;/home/jana/untitled.png&quot;,
                            tr(&quot;Images (*.png *.xpm *.jpg)&quot;));</pre>
<p>The file dialog's working directory will be set to <i>dir</i>. If <i>dir</i> includes a file name, the file will be selected. Only files that match the <i>filter</i> are shown. The filter selected is set to <i>selectedFilter</i>. The parameters <i>dir</i>, <i>selectedFilter</i>, and <i>filter</i> may be empty strings. The <i>options</i> argument holds various options about how to run the dialog, see the <a href="qfiledialog.html#Option-enum">QFileDialog::Option</a> enum for more information on the flags you can pass.</p>
<p>The default filter can be chosen by setting <i>selectedFilter</i> to the desired value.</p>
<p>The dialog's caption is set to <i>caption</i>. If <i>caption</i> is not specified then a default caption will be used.</p>
<p>Under Windows and Mac OS X, this static function will use the native file dialog and not a <a href="qfiledialog.html">QFileDialog</a>.</p>
<p>Note that on Windows the dialog will spin a blocking modal event loop that will not dispatch any QTimers, and if parent is not 0 then it will position the dialog just under the parent's title bar. On Mac OS X, the filter argument is ignored.</p>
<p>Under Unix/X11, the normal behavior of the file dialog is to resolve and follow symlinks. For example, if <tt>/usr/tmp</tt> is a symlink to <tt>/var/tmp</tt>, the file dialog will change to <tt>/var/tmp</tt> after entering <tt>/usr/tmp</tt>. If <i>options</i> includes <a href="qfiledialog.html#Option-enum">DontResolveSymlinks</a>, the file dialog will treat symlinks as regular directories.</p>
<p>See also <a href="qfiledialog.html#getOpenFileName">getOpenFileName</a>(), <a href="qfiledialog.html#getOpenFileNames">getOpenFileNames</a>(), and <a href="qfiledialog.html#getExistingDirectory">getExistingDirectory</a>().</p>
<h3 class="fn"><a name="history"></a><a href="qstringlist.html">QStringList</a> QFileDialog::history () const</h3>
<p>returns the browsing history of the filedialog as a list of paths.</p>
<p>See also <a href="qfiledialog.html#setHistory">setHistory</a>().</p>
<h3 class="fn"><a name="iconProvider"></a><a href="qfileiconprovider.html">QFileIconProvider</a> * QFileDialog::iconProvider () const</h3>
<p>returns the icon provider used by the filedialog.</p>
<p>See also <a href="qfiledialog.html#setIconProvider">setIconProvider</a>().</p>
<h3 class="fn"><a name="itemDelegate"></a><a href="qabstractitemdelegate.html">QAbstractItemDelegate</a> * QFileDialog::itemDelegate () const</h3>
<p>returns the item delegate used to render the items in the views in the filedialog</p>
<p>See also <a href="qfiledialog.html#setItemDelegate">setItemDelegate</a>().</p>
<h3 class="fn"><a name="labelText"></a><a href="qstring.html">QString</a> QFileDialog::labelText ( <a href="qfiledialog.html#DialogLabel-enum">DialogLabel</a> <i>label</i> ) const</h3>
<p>returns the text shown in the filedialog in the specified <i>label</i></p>
<p>See also <a href="qfiledialog.html#setLabelText">setLabelText</a>().</p>
<h3 class="fn"><a name="proxyModel"></a><a href="qabstractproxymodel.html">QAbstractProxyModel</a> * QFileDialog::proxyModel () const</h3>
<p>Returns the proxy model used by the file dialog. By default no proxy is set.</p>
<p>See also <a href="qfiledialog.html#setProxyModel">setProxyModel</a>().</p>
<h3 class="fn"><a name="restoreState"></a>bool QFileDialog::restoreState ( const <a href="qbytearray.html">QByteArray</a> &amp; <i>state</i> )</h3>
<p>Restores the dialogs's layout, history and current directory to the <i>state</i> specified.</p>
<p>Typically this is used in conjunction with <a href="qsettings.html">QSettings</a> to restore the size from a past session.</p>
<p>Returns false if there are errors</p>
<p>This function was introduced in Qt 4.3.</p>
<h3 class="fn"><a name="saveState"></a><a href="qbytearray.html">QByteArray</a> QFileDialog::saveState () const</h3>
<p>Saves the state of the dialog's layout, history and current directory.</p>
<p>Typically this is used in conjunction with <a href="qsettings.html">QSettings</a> to remember the size for a future session. A version number is stored as part of the data.</p>
<p>This function was introduced in Qt 4.3.</p>
<h3 class="fn"><a name="selectFile"></a>void QFileDialog::selectFile ( const <a href="qstring.html">QString</a> &amp; <i>filename</i> )</h3>
<p>Selects the given <i>filename</i> in the file dialog.</p>
<p>See also <a href="qfiledialog.html#selectedFiles">selectedFiles</a>().</p>
<h3 class="fn"><a name="selectFilter"></a>void QFileDialog::selectFilter ( const <a href="qstring.html">QString</a> &amp; <i>filter</i> )</h3>
<p>Sets the current file type <i>filter</i>. Multiple filters can be passed in <i>filter</i> by separating them with semicolons or spaces.</p>
<p>See also <a href="qfiledialog.html#setFilter">setFilter</a>(), <a href="qfiledialog.html#setFilters">setFilters</a>(), and <a href="qfiledialog.html#selectedFilter">selectedFilter</a>().</p>
<h3 class="fn"><a name="selectedFiles"></a><a href="qstringlist.html">QStringList</a> QFileDialog::selectedFiles () const</h3>
<p>Returns a list of strings containing the absolute paths of the selected files in the dialog. If no files are selected, or the mode is not <a href="qfiledialog.html#FileMode-enum">ExistingFiles</a>, selectedFiles() is an empty string list.</p>
<p>See also <a href="qfiledialog.html#selectedFilter">selectedFilter</a>() and <a href="qfiledialog.html#selectFile">selectFile</a>().</p>
<h3 class="fn"><a name="selectedFilter"></a><a href="qstring.html">QString</a> QFileDialog::selectedFilter () const</h3>
<p>Returns the filter that the user selected in the file dialog.</p>
<p>See also <a href="qfiledialog.html#selectedFiles">selectedFiles</a>().</p>
<h3 class="fn"><a name="setDirectory"></a>void QFileDialog::setDirectory ( const <a href="qstring.html">QString</a> &amp; <i>directory</i> )</h3>
<p>Sets the file dialog's current <i>directory</i>.</p>
<p>See also <a href="qfiledialog.html#directory">directory</a>().</p>
<h3 class="fn"><a name="setDirectory-2"></a>void QFileDialog::setDirectory ( const <a href="qdir.html">QDir</a> &amp; <i>directory</i> )</h3>
<p>This is an overloaded member function, provided for convenience.</p>
<h3 class="fn"><a name="setFilter"></a>void QFileDialog::setFilter ( const <a href="qstring.html">QString</a> &amp; <i>filter</i> )</h3>
<p>Sets the filter used in the file dialog to the given <i>filter</i>.</p>
<p>If <i>filter</i> contains a pair of parentheses containing one or more of <b>anything*something</b>, separated by semicolons, then only the text contained in the parentheses is used as the filter. This means that these calls are all equivalent:</p>
<pre> dialog.setFilter(&quot;All C++ files (*.cpp;*.cc;*.C;*.cxx;*.c++)&quot;);
 dialog.setFilter(&quot;*.cpp;*.cc;*.C;*.cxx;*.c++&quot;);</pre>
<p>See also <a href="qfiledialog.html#setFilters">setFilters</a>().</p>
<h3 class="fn"><a name="setFilters"></a>void QFileDialog::setFilters ( const <a href="qstringlist.html">QStringList</a> &amp; <i>filters</i> )</h3>
<p>Sets the <i>filters</i> used in the file dialog.</p>
<pre> QStringList filters;
 filters &lt;&lt; &quot;Image files (*.png *.xpm *.jpg)&quot;
         &lt;&lt; &quot;Text files (*.txt)&quot;
         &lt;&lt; &quot;Any files (*)&quot;;

 QFileDialog dialog(this);
 dialog.setFilters(filters);
 dialog.exec();</pre>
<p>See also <a href="qfiledialog.html#filters">filters</a>().</p>
<h3 class="fn"><a name="setHistory"></a>void QFileDialog::setHistory ( const <a href="qstringlist.html">QStringList</a> &amp; <i>paths</i> )</h3>
<p>Sets the browsing history of the filedialog to contain the given <i>paths</i>.</p>
<p>See also <a href="qfiledialog.html#history">history</a>().</p>
<h3 class="fn"><a name="setIconProvider"></a>void QFileDialog::setIconProvider ( <a href="qfileiconprovider.html">QFileIconProvider</a> * <i>provider</i> )</h3>
<p>set the icon provider used by the filedialog to the specified <i>provider</i></p>
<p>See also <a href="qfiledialog.html#iconProvider">iconProvider</a>().</p>
<h3 class="fn"><a name="setItemDelegate"></a>void QFileDialog::setItemDelegate ( <a href="qabstractitemdelegate.html">QAbstractItemDelegate</a> * <i>delegate</i> )</h3>
<p>Sets the item delegate used to render items in the views in the file dialog to the given <i>delegate</i>.</p>
<p><b>Warning:</b> You should not share the same instance of a delegate between views. Doing so can cause incorrect or unintuitive editing behavior since each view connected to a given delegate may receive the <a href="qabstractitemdelegate.html#closeEditor">closeEditor()</a> signal, and attempt to access, modify or close an editor that has already been closed.</p>
<p>See also <a href="qfiledialog.html#itemDelegate">itemDelegate</a>().</p>
<h3 class="fn"><a name="setLabelText"></a>void QFileDialog::setLabelText ( <a href="qfiledialog.html#DialogLabel-enum">DialogLabel</a> <i>label</i>, const <a href="qstring.html">QString</a> &amp; <i>text</i> )</h3>
<p>set the <i>text</i> shown in the filedialog in the specified <i>label</i></p>
<p>See also <a href="qfiledialog.html#labelText">labelText</a>().</p>
<h3 class="fn"><a name="setProxyModel"></a>void QFileDialog::setProxyModel ( <a href="qabstractproxymodel.html">QAbstractProxyModel</a> * <i>proxyModel</i> )</h3>
<p>Sets the model for the views to the given <i>proxyModel</i>. This is useful if you want to modify the underlying model; for example, to add columns, filter data or add drives.</p>
<p>Any existing proxy model will be removed, but not deleted. The file dialog will take ownership of the <i>proxyModel</i>.</p>
<p>This function was introduced in Qt 4.3.</p>
<p>See also <a href="qfiledialog.html#proxyModel">proxyModel</a>().</p>
<h3 class="fn"><a name="setSidebarUrls"></a>void QFileDialog::setSidebarUrls ( const <a href="qlist.html">QList</a>&lt;<a href="qurl.html">QUrl</a>&gt; &amp; <i>urls</i> )</h3>
<p>Sets the <i>urls</i> that are located in the sidebar</p>
<p>This function was introduced in Qt 4.3.</p>
<p>See also <a href="qfiledialog.html#sidebarUrls">sidebarUrls</a>().</p>
<h3 class="fn"><a name="sidebarUrls"></a><a href="qlist.html">QList</a>&lt;<a href="qurl.html">QUrl</a>&gt; QFileDialog::sidebarUrls () const</h3>
<p>Returns a list of urls that are currently in the sidebar</p>
<p>This function was introduced in Qt 4.3.</p>
<p>See also <a href="qfiledialog.html#setSidebarUrls">setSidebarUrls</a>().</p>
<p /><address><hr /><div align="center">
<table width="100%" cellspacing="0" border="0"><tr class="address">
<td width="30%">Copyright &copy; 2008 <a href="trolltech.html">Trolltech</a></td>
<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>
<td width="30%" align="right"><div align="right">Qt 4.3.5</div></td>
</tr></table></div></address></body>
</html>
